Truee MCP Server
Give your AI agent access to verified African business data — instantly.
Endpoint: https://api.usetruee.com/mcp
Transport: HTTP JSON-RPC (MCP 2024-11-05)
Auth: API key via x-api-key header
What is Truee?
Truee is a verified business directory for Africa. The Truee MCP server lets AI agents search, filter, and retrieve detailed profiles of verified businesses — with contact info, location, services, branches, and verification status.
Quickstart
1. Get an API key
Sign up at usetruee.com and generate an API key from your dashboard.
2. Add to Claude Desktop
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"truee": {
"type": "http",
"url": "https://api.usetruee.com/mcp",
"headers": {
"x-api-key": "YOUR_API_KEY"
}
}
}
}
3. Add to Cursor
Add this to your Cursor MCP settings:
{
"truee": {
"type": "http",
"url": "https://api.usetruee.com/mcp",
"headers": {
"x-api-key": "YOUR_API_KEY"
}
}
}
Tools
search_businesses
Search for businesses using natural language or structured filters. Powered by AI query understanding.
{
"query": "logistics companies in Lagos",
"country": "NG",
"limit": 10
}
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Natural language or keyword search |
city | string | No | Filter by city |
state | string | No | Filter by state or region |
country | string | No | Filter by country (e.g. NG, GH) |
category | string | No | Category code — use list_categories to see options |
area | string | No | Neighbourhood or market name (e.g. Victoria Island) |
lat / lng | number | No | Coordinates for proximity search |
radius | number | No | Search radius in km (default 50, max 1000) |
limit | number | No | Results per page (1–50, default 10) |
page | number | No | Page number (default 1) |
query_businesses
Structured search without AI query parsing — faster and cheaper (1 credit vs 2). Use when you already know the exact keywords.
{
"keywords": "fabric seller",
"city": "Ibadan",
"country": "NG"
}
Same parameters as search_businesses, but uses keywords instead of query.
get_business
Fetch the full profile of a specific business by its ID or URL slug.
{
"id_or_slug": "acme-logistics-ng"
}
Returns: services, products, branches, verifications, social links, and all contact info.
list_categories
List all available business category codes. Use the returned codes in search_businesses or query_businesses.
{}
No parameters required.
Example Prompts
Once connected, you can ask your AI agent things like:
- "Find me verified fintech companies in Lagos"
- "What logistics companies operate in Abuja?"
- "Show me the full profile for acme-logistics-ng"
- "What business categories does Truee cover?"
- "Find fabric sellers near Victoria Island within 10km"
Raw JSON-RPC Example
curl -X POST https://api.usetruee.com/mcp \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_businesses",
"arguments": {
"query": "fintech companies in Nigeria",
"limit": 5
}
}
}'
Pricing
Each tool call costs credits from your Truee account:
| Tool | Credits |
|---|---|
search_businesses | 2 credits |
query_businesses | 1 credit |
get_business | 1 credit |
list_categories | 0 credits |
Get credits at usetruee.com.
API Reference
Full API docs: https://api.usetruee.com/mcp/docs
Support
- Website: usetruee.com
- Email: support@usetruee.com
Server Config
{
"mcpServers": {
"truee": {
"type": "http",
"url": "https://api.usetruee.com/mcp",
"headers": {
"x-api-key": "YOUR_API_KEY"
}
}
}
}